Internet- 
Login-Scripts 


Scripts zum Herstellen der Internet- 
Verbindung erstellen 


© Copyright Psion Computers Plc 1997-1999 

Eine teilweise oder vollständige Wiedergabe einschließlich des Gebrauchs 
maschineller Wiedergabevorrichtungen ist nur mit ausdrücklicher 
schriftlicher Genehmigung der Inhaber der Urheberrechte zulässig. 
Nachentwicklungen sind ebenfalls unzulässig. 

Die in diesem Handbuch enthaltenen Informationen können ohne 
Vorankündigung geändert werden. 

Einige in diesem Handbuch enthaltene Namen sind eingetragene 
Warenzeichen. 


Version 1.00 
October 1999 
German 


© Copyright Symbian Ltd. 1997-1999 

Für einen Teil des IMAP4-Softwarezusatzes liegt das © Copyright bei ANT 
Ltd. 1998. Alle Rechte vorbehalten. 

Integrierte MPPC® Komprimierung von Hi/fn'”. 

Stac ®, LZS ®, ©1996, Stac, Inc., ©1994-1996 Microsoft Corporation. 
Beinhaltet ein oder mehrere US-amerikanische Patente: Nr. 4701745, 
5016009, 5126739, 5146221 und 5414425. Weitere Patente sind 
angemeldet. 

Integrierte LZS® Komprimierung von Hi/fnTM. Hi/fn ®, LZS ®, ©1983- 
98, Hi/fn. Beinhaltet ein oder mehrere US-amerikanische Patente: Nr. 
4701745, 5016009, 5126739, 5146221 und 5414425. Weitere Patente sind 
angemeldet. 


Die Scriptsprache 


Überblick über die Erstellung von Verbindungsscripts 


Über das Programm iSetup auf Ihrem Revo geben Sie die Internet- und E-Mail-Einstellungen ein, einschließlich der 
Internet “Login-Scripts”. Mit einem Login-Script Können Sie den Verbindungsvorgang automatisieren, wenn Ihr 
Internet Service Provider (ISP) beim Einloggen die Eingabe von Text erfordert. Die Programmiersprache ermöglicht es 
Ihnen, ein Script zu erstellen, das dem Rechner Ihres Service Providers beim Einloggen automatisch die erforderlichen 
Angaben wie Ihren Benutzernamen und das Kennwort übermittelt. 


Wann ist ein Script erforderlich? 


Bei einigen Internet Service Providern müssen Sie sich über einen Terminal-Prompt anmelden. Im Verlauf dieses 
textbasierten Einlogvorgangs fordert Sie der Rechner des Service Providers normalerweise auf, Angaben wie 
Benutzernamen und Kennwort von Hand einzugeben. Wenn dies bei Ihrem Service Provider der Fall ist, müssen Sie ein 
Script verwenden. 


Verwendung von Scripts 


So verwenden Sie ein Script für das Einloggen: 

1. Öffnen Sie das Programm iSetup über die Extrasleiste. 

2. Erstellen Sie einen neuen Internetdienst, oder bearbeiten Sie einen bereits vorhandenen. 

3. Tippen Sie auf der Seite Login-Script auf Ja, um zu bestätigen, dass Sie ein Login-Script benötigen, und tippen Sie 
dann auf Weiter. 

4. Geben Sie Ihr Login-Script in den Scripteditor ein. 
Im Scripteditor wird Ihnen eine Scriptvorlage angezeigt. In den meisten Fällen ist es möglich, diese an die 
Anforderungen Ihres Service Providers anzupassen, so dass Sie kein vollkommen neues Script erstellen müssen. 
Wenn Sie mehr über die Erstellung und Bearbeitung von Scripts erfahren möchten, lesen Sie die folgenden 
Abschnitte. 

5. Nach Eingabe Ihres Scripts tippen Sie auf Weiter. Sobald Sie alle erforderlichen Eingaben in iSetup, E-Mail und 
Web (sofern installiert) vorgenommen haben, können Sie mit Hilfe Ihres Scripts die Verbindung zum Internet 
herstellen. 


Script für Ihren Internet Service Provider erstellen 


Zum Öffnen des Scripteditors müssen Sie zunächst iSetup öffnen und zur Seite Login-Script für Ihren Internet 
Service wechseln. 

Erstellen Sie das Script so, dass es folgende Richtlinien erfüllt: 

e Es muss auf spezifische Prompts warten, die vom Server des Internet Service Providers gesendet werden, wie z. B. 
‘login:’. Sie erreichen dies mit dem Befehl WAIT. 

e Es muss die richtigen Antworten senden, z. B. Ihren Benutzernamen gefolgt von ENTER. Verwenden Sie dafür die 
Befehle SEND und READ. 

e Es muss sich nach dem Einloggen schließen und gegebenenfalls eine Fehlermeldung anzeigen, wenn etwas nicht 
funktioniert hat. 

Außerdem sollten Sie die verschiedenen Teile des Scripts in Prozeduren aufteilen (eine Prozedur ist ein 

Unterprogramm, das mit einem Namen beginnt, über den die in ihm enthaltenen Befehle von jeder anderen Stelle des 

Scripts aus aufgerufen werden können). 

°e Jede Prozedur muss mit einem Namen, gefolgt von einem Doppelpunkt, beginnen. In der nächsten Zeile stehen die 
entsprechenden Befehle. Beispielsweise ist in 


start: 
WAIT 15 
“start” der Name der Prozedur. Durch Verwendung des folgenden Befehls können Sie das Script dazu veranlassen, 
von einem beliebigen Punkt aus zur start-Prozedur zu springen: 
GOTO start 


Ein Prozedurname (auch “Label” genannt) darf maximal 20 Zeichen umfassen. 
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Auf Prompts warten 


So weisen Sie das Gerät mit Hilfe eines Scripts dazu an, auf einen Prompt zu warten: 


—_ 


Für jeden Prompt, den Ihnen Ihr Internet Service Provider während des Einloggens sendet, sollten Sie jeweils den 
Befehl WAIT verwenden. 

Öffnen Sie den Scripteditor. 

Wenn Sie eine neue Prozedur für den Prompt erstellen möchten, auf den das Script warten soll, geben Sie den 
Prozedurnamen, gefolgt von einem Doppelpunkt, an. Beispielsweise: 


waitforlogin: 
Schreiben Sie in die nächste Zeile WAIT, gefolgt von der Anzahl der Sekunden, die das Gerät auf den Prompt 
warten soll. Beginnen Sie eine weitere neue Zeile, in die Sie das Zeichen "{" setzen. Das sieht in etwa wie folgt aus: 


waitforlogin: 
WAIT 15 
{ 


Beim Erstellen eines Scripts erweist es sich oft als hilfreich, jede neue Zeile mit Hilfe der Tab-Taste einzurücken. 
So können Sie beim Prüfen des Scripts die Prozedurnamen besser als solche erkennen. 

Geben Sie in einer weiteren neuen Zeile in Anführungszeichen den Prompt an, auf den das Gerät warten soll. 
Schreiben Sie im Anschluss daran den Namen der Prozedur, die das Script bei Empfang des Prompt aufrufen soll. 
(Dabei handelt es sich um die Prozedur, die den Befehl für die Übermittlung der entsprechenden Antwort enthält.) 
Tragen Sie in eine neue Zeile das Zeichen "}" ein. Die Anweisung sieht dann in etwa wie folgt aus: 


waitforlogin: 
WAIT 15 
{ 
”ogin:” sendlogin 


} 


Da beim Scripting-Tool die Groß- und Kleinschreibung berücksichtigt wird und Ihr Service Provider den Prompt 
als ‘login: ’ oder ‘Login: übermitteln kann, empfiehlt es sich, bei der Angabe des Prompt im Befehl WAIT den 
ersten oder sogar die ersten beiden Buchstaben wegzulassen. 


Wenn Sie den Prozedurnamen (im obigen Beispiel lautete dieser: sendlogin) an anderer Stelle als am Anfang 
angeben, darf anschließend kein Doppelpunkt folgen. 

Schreiben Sie den Befehl, der ausgeführt werden soll, wenn das Gerät den von Ihnen angegebenen Prompt nicht 
empfängt, in eine neue Zeile. In 


waitforlogin: 
WAIT 15 
{ 


”ogin:” sendlogin 


} 

GOTO failure 
weisen Sie Ihr Script beispielsweise an, die Prozedur mit dem Namen failure aufzurufen, wenn nicht innerhalb von 
15 Sekunden die Zeichenfolge ogin: empfangen wird. 


Ihr Script sollte für jeden Prompt, den Ihnen Ihr Service Provider im Verlauf des Einloggens übermittelt, einen WAIT- 
Befehl enthalten. Für jeden dieser Befehle sollte es einen SEND-Befehl für die Übermittlung der entsprechenden 
Antwort geben. 
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Antworten senden 


Sie können die Befehle SEND und READ verwenden, um eine Antwort an Ihren Internet Service Provider zu 
übermitteln, z. B. wenn beim Einlogvorgang ein Kennwort oder ein Benutzername erforderlich ist. Verwenden Sie den 
Befehl SEND, wenn Sie Text oder eine Variable übermitteln möchten oder den Befehl READ, wenn der Benutzer zu 
einer Eingabe aufgefordert werden soll. 


So verwenden Sie den Befehl SEND zum Senden von Text: 

1. Schreiben Sie den Namen einer Prozedur in eine neue Zeile, gefolgt von einem Doppelpunkt. 

2. Geben Sie in der Zeile darunter SEND, gefolgt von diesen Angaben, ein: 

e Den gewünschten Text, eingeschlossen zwischen "", bzw. 

e die Zeichenfolge login_name$, wenn Ihr Revo das übertragen soll, was Sie in der Zeile Benutzername auf der 
Seite Konto für Ihren Internetdienst eingetragen haben. 

e Die Zeichenfolge <0x0d> für die Stellen, an denen Sie normalerweise ENTER drücken, wenn Sie sich manuell 
einloggen. 

e Eine beliebige Kombination der vorangegangenen Zeichenfolgen, die mit dem Zeichen + verbunden sind. 
Beispielsweise: 


SEND login_name$+<0x0d> 
3. Auf einen SEND-Befehl sollten Sie jeweils den nächsten dem Einlogvorgang entsprechenden WAIT-Befehl folgen 
lassen. Nachdem Sie beispielsweise Ihren Benutzernamen gesendet haben, sollten Sie das Gerät anweisen, auf den 
Prompt ‘Kennwort :’ zu warten: 


sendlogin: 
SEND login_name$+<0x0d> 
WAIT 15 


”word:” sendpass 


} 
GOTO failure 

Die oben beschriebenen Schritte zur Erstellung von WAIT- und SEND-Befehlen sind für jeden vom Server übermittelten 
Prompt zu wiederholen, der eine Antwort erfordert. 
So senden Sie die Informationen, die in der Zeile Kennwort auf der Seite Konto für Ihren Internetdienst eingegeben 
wurden: 
® Schreiben Sie SEND login_pass$, und fügen Sie +<0x0d> hinzu, wenn Sie normalerweise nach der Eingabe des 

Kennworts ENTER drücken würden. 
So senden Sie die Informationen, die in der Zeile IP-Adresse auf der Seite Adressen für Ihren Internetdienst 
eingegeben wurden: 
® Schreiben Sie SEND login_ipaddr$, und fügen Sie +<0x0d> hinzu, wenn Sie normalerweise nach der Eingabe der 

IP-Adresse die ENTER-Taste drücken würden. 
So verwenden Sie den Befehl READ zum Versenden von Text: 
Verwenden Sie den Befehl READ anstelle des Befehls SEND, wenn der Benutzer bei jedem Einloggen Angaben machen 
muss. Beispielsweise können Sie den Befehl READ verwenden, wenn sich der Benutzer bei einem durch das 
“Challenge-Response”-Verfahren gesicherten System anmeldet, bei dem ein Code angezeigt wird, der durch ein 
entsprechendes Kennwort zu ergänzen ist. Wenn Sie den Befehl READ in einem Script verwenden, wird der Post- 
Connection Terminal-Dialog (PCT-Dialog) angezeigt. Wenn der Benutzer Text in den PCT-Dialog eingibt und ENTER 
drückt, wird dieser Text (zusammen mit dem Steuerzeichen Carriage Return) an den Server gesendet. Im nächsten 
Script-Abschnitt folgt auf den Befehl SEND zum Senden des Login-Namens der Befehl READ, damit der Benutzer sein 
Kennwort eingeben kann: 


sendlogin: 
SEND login_name$+<0x0d> 
WAIT 15 
{ 


"word:" sendpass 


} 


sendpass: 
READ 
Nach dem Senden des Login-Namens springt das Script zur sendpass-Prozedur. In der sendpass-Prozedur kann der 
Benutzer wegen des Befehls READ sein Kennwort in den PCT-Dialog eingeben. Nachdem der Benutzer sein Kennwort 
eingegeben und ENTER gedrückt hat, wird der Text an den Server gesendet und das Script ab dem Ende des READ- 
Befehls ausgeführt. 


Internet-Login-Scripts 4 


Script beenden 


Nachdem Ihr Script das Gerät angewiesen hat, auf alle beim Einloggen vom Server Ihres Service Providers 
übermittelten Prompts zu warten und diese entsprechend zu beantworten, sollte es beendet werden. Sie können das 
Script mit dem Befehl EXIT, wie im nachstehenden Beispiel gezeigt, beenden: 


sendpass: 
SEND login_pass$+<0x0d> 
WAIT 15 


”ello” success 


} 


SUCCESS: 
EXIT 
In diesem Fall sendet das Gerät Ihr Kennwort und wartet auf die Meldung ello (normalerweise wird Ihr Service 
Provider Sie nach erfolgreichem Einloggen mit der Meldung "Hello" oder "OK" begrüßen). Nach dem Erhalt dieser 
Meldung ruft das Gerät die Prozedur success auf, durch die das Script beendet wird. 


Fehlermeldungen anzeigen 


Sie können Ihr Script anweisen, für alle während des Einloggens auftretenden Probleme Fehlermeldungen anzuzeigen. 

Hierfür haben sich zwei Möglichkeiten als zweckmäßig erwiesen: 

1. Verwenden Sie an der Stelle des Scripts, an der Ihres Erachtens nach ein Problem auftreten könnte, den Befehl 
EXIT in Verbindung mit einem der festgelegten Fehlerstrings, beispielsweise: 


sendlogin: 
SEND ”fred15” 
WAIT 15 


”word:” sendpass 


} 
GOTO loginfail 


loginfail: 

EXIT KErrLoginFail$ 
In diesem Scriptabschnitt sendet das Gerät den Benutzernamen fred15 und wartet dann auf den Prompt word:. 
Wird dieser nicht innerhalb von 15 Sekunden empfangen, so wird die Prozedur loginfail aufgerufen, die das Script 
beendet und gleichzeitig einen Login-Fehler meldet. 


Der Abschnitt EXIT des nachstehenden Script-Glossars enthält eine ausführliche Liste von Fehlern, für die Sie den 
Befehl EXIT auf diese Weise nutzen können. 

2. Verwenden Sie den Befehl WAIT, um auf mehrere Antworten zu warten, einschließlich alternativer Antworten, die 
darauf hindeuten können, dass der Server einen Fehler meldet. Beispielsweise: 


sendlogin: 
SEND ”fred15” 
WAIT 15 


”word:” sendpass 
”nvalid” badlogin 
”ncorrect” badlogin 
”rror” failure 


} 
EXIT KerrTimeOut$ 


badlogin: 
EXIT KErrLoginFail$ 


failure: 

EXIT KErrGeneral$ 
Im obigen Scriptabschnitt sendet das Gerät den Benutzernamen fred15 und wartet dann auf den Prompt word:. 
Wenn dieser innerhalb von 15 Sekunden empfangen wird, ruft das Script die Prozedur sendpass auf (auf die im 
obigen Beispiel nicht näher eingegangen wird). Wenn Ihr Gerät stattdessen die Prompts nvalid, ncorrect oder rror 
erhält, ruft das Script die Prozedur badlogin oder failure auf, je nach Art des gemeldeten Fehlers. Wenn innerhalb 
der festgelegten Zeit keine der oben genannten Meldungen eingehen, wird das Script beendet und die Meldung 
"timed out" (Zeitabschaltung/Zeitüberschreitung) angezeigt. 
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Befehle der Scriptsprache 


Dieser Abschnitt enthält eine Liste aller Befehle der Scriptsprache. Die einzelnen Einträge der Liste sind wie folgt 
dargestellt: 


Die Syntax für den 
Befehl und seine 
Verwendung. 


Der Scriptbefehl. 


Die Erläuterung des 
Befehls. 


In eckigen Klammern [ ] angegebene Elemente sind optional. 


! ! [comment] 
Kennzeichnet Textstellen als Kommentar: Die Software ignoriert alle Textstellen ab dem Ausrufungszeichen bis zum 
Zeilenende. Beispiel: 


! send my username now 
SEND ”fred15” 


EXIT EXIT [expression$] 
Beendet das Script. Wenn ein String bereitgestellt wird (dargestellt durch expression$), wie z. B. "No carrier " (Kein 
Trägersignal) oder "Logging in complete" (Login beendet), so wird er bei Beendigung des Scripts als Information 
angezeigt. 
Wenn Sie expression$ durch eines der nachstehenden Elemente ersetzen, wird bei Beendigung des Scripts jeweils die 
entsprechende vordefinierte Fehlermeldung angezeigt. 


KErrNoModem$ Zeigt an, dass kein Modem gefunden wurde. 

KErrNoCarrier$ Zeigt an, dass keine Telefonleitung gefunden wurde. 
KErrNoDialTone$ Zeigt an, dass in der Telefonleitung kein Wählton erkannt wurde. 
KErrBusy$ Zeigt an, dass nach dem Wählen ein Besetzt-Zeichen erkannt wurde. 
KErrNoAnswer$ Zeigt an, dass der Anruf nicht beantwortet wurde. 

KErrLoginFail$ Zeigt an, dass beim Einloggen ein Problem aufgetreten ist. 
KErrGeneral$ Zeigt einen allgemeinen Fehler an. 

KErrModemeError$ Zeigt an, dass ein Modemfehler aufgetreten ist. 


KErrModeminitError$ Zeigt an, dass beim Initialisieren des Modems ein Fehler aufgetreten ist. 
KErrModemResetError$ Zeigt an, dass beim Rücksetzen des Modems ein Problem aufgetreten ist. 
KErrTimeOut$ Zeigt an, dass nach dem Warten auf eine Antwort eine Zeitabschaltung erfolgte. 


GOTO GOTO label 
Mit diesem Befehl wird das Script angewiesen, zu dem von Ihnen angegebenen Label zu springen. Wenn Sie in einem 
GOTO-Befehl ein Label verwenden, müssen Sie danach keinen Doppelpunkt setzen. 


LOOP LOOP m 
{ 
} 
Wiederholt die in Klammern angegebenen Befehle m mal. Wenn die Befehle so oft wiederholt wurden, wie angegeben, 
fährt das Script mit dem nächsten Befehl fort. 
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READ READ 
Weist die Software an, den Post-Connection Terminal-Dialog (PCT-Dialog) anzuzeigen, so dass der Benutzer Text, wie 
z.B. ein Kennwort, eingegeben kann. Wenn der Benutzer Text in den PCT-Dialog eingibt und ENTER drückt, wird dieser 
Text (zusammen mit dem Steuerzeichen Carriage Return) an den Server gesendet. 


SEND SEND expression$ 
Sendet den durch expression$ dargestellten Text an den Remote-Server. Der als expression$ verwendete Text muss in 
Anführungszeichen "" stehen. Stattdessen können Sie auch eine Variable senden, die Sie mit Hilfe des Befehls SET 
definiert haben. Einzelheiten dazu finden Sie nachstehend unter dem Befehl SET. 


SET SET VariableName$=expression$ 
Definiert die Variable VarName$ als den Ausdruck expr$. Sie können sie zur Darstellung von Textvariablen verwenden. 
Wenn Ihr Script beispielsweise folgende Zeile am Anfang enthält: 


set login$="fred15” 
können Sie an einer anderen Stelle im Script die folgende Zeile verwenden: 


SEND login$ 
Damit wird die Zeichenfolge fred15’ gesendet. 
Variablen dürfen nur Textstrings sein und keine Ziffern enthalten. Deshalb müssen alle Namen von Variablen mit 
dem Zeichen "$" enden. 


Der Name einer Variablen darf einschließlich des Zeichens "$" nicht mehr als 20 Zeichen umfassen. Bei 
Verwendung eines längeren Namens tritt beim Einloggen ein Fehler auf. 


WAIT WAITn{ 
expr1$ label 
expr2$ label2 
expr3$ label3 


} 


Mit dem Befehl WAIT wird das Script n Sekunden lang angehalten bzw. so lange, bis einer der festgelegten Strings 
empfangen wurde. Wenn nach Ablauf von n Sekunden keiner der in Klammern angegebenen Ausdrücke empfangen wurde, 
fährt das Script mit dem nächsten Befehl fort. Wenn innerhalb von n Sekunden einer der Strings empfangen wurde, springt 
das Script zu dem neben dem betreffenden String angegebenen Label. 

Beispielsweise: 


WAIT 15 

{ 

”Protocol:” sendprot 
”elcome” stopscript 


} 

EXIT 
Wenn Sie in einem Script die Zeile: 
WAIT n {} 


verwenden, wartet das Gerät n Sekunden und fährt dann mit dem nächsten Befehl im Script fort, unabhängig 
davon, ob in diesem Zeitraum Text empfangen wurde. 
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